Inside Macintosh: QuickDraw GX Objects /

Chapter 5 - Ink Objects / Ink Objects Reference

Functions / Creating and Manipulating Ink Objects

GXNewInk

You can use the GXNewInk function to create a new ink object with default properties.

gxInk GXNewInk(void);

function result

A reference to a newly created copy of the default ink object.

DESCRIPTION

The GXNewInk function creates an ink object with an owner count of 1. All other properties of the ink are set to their default values:

• No attributes set.
• An empty tag list.
• An owner count of 1.
• Color space set to gxRGBSpace with each color component set to 0, which represents black in this color space.
• Transfer mode set to gxCopyMode, with identity transfer mode matrices, color limits of 0 to 0xFFFF (gxColorValue1), and all flags cleared.

SPECIAL CONSIDERATIONS

If no error occurs, the GXNewInk function creates an ink object; you are responsible for disposing of that object when you no longer need it.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory

SEE ALSO

Default ink values are described in the section "The Default Ink Object" on page 5-10.